Options

hsc understands the following options:

Help

Display a short help message.

[from=]infile

Specifies the input filename. To use stdin as input file, see PipeIn.

[to=]outfile

Specifies the output filename. If no output file is given, stdout is used instead.

DestDir=destination_directory

Specifies the destination directory for output file.

Errfile=errfile

Redirects error output to a file. By default, stderr ist used.

Ignore=IGN

Ignore warning message number. Numeric, can occure multiple. (eg IGN=21 IGN=18.)

Switches

AbsUri

Enable Absolute URIs

CheckUri

Check existence of local URIs

RplcEnt

Replace special charaters with its entity (eg "ü" becomes "&uuml").

SmartEnt

Replace special charaters "&", "<", ">", "\"" (quote) with its entity (&, <, > ") if they are surrounded by white-spaces.

Status

Display file and line number during conversion. Included files are also displayed. After processing a file, the filename and the total number of lines remain visible. (output goes to stderr.)

Verbose

More verbose status output. Enables the Status-switch.

Examples

hsc FROM hugo.html TO t:

Simly performs a syntax check on hugo.html and writes a dummy-output to the temporary directory.

hsc hugo.html t: STATUS RPLCENT

Same as above, but also displays a status message during conversion. Additionally, all special characters like "Ü" or "ß" are replaced by its entities ("&Uuml;" and "&szlig;")

hsc FROM people/hugo.hsc DESTDIR /pub_html STATUS ABSURI

Process subfile people/hugo.hsc. The current directory is the main directory of the project. The HTML-object is created in /pub_html/people/hugo.hsc. All local URIs referenced within hugo.hsc are interpreted as absolut URIs and are converted to relative path when written to the HTML-object.

hsc FROM people/hugo.hsc DESTDIR /pub_html STATUS ABSURI CHECKURI

Same as above. Additionally, all URIs referenced are checked for existence. If eg, people/hugo.hsc references to prog/project/thing.hsc, the file /pub_html/project/thing.html must exist or an error will occure.
Note: Also mind that the HSC-source ends with ".hsc", but the HTML-object automatically gets the extension ".html". Therefor, all references must end with ".html".